Release 10.1A: OpenEdge Development:
Progress 4GL Reference

GET-PROPERTY( ) method

Gets the value of the specified application-defined property associated with the Client-principal object. The Client-principal object may be sealed or unsealed. If the specified property is not a valid property for the Client-principal object, or the property does not have a value, this method returns the Unknown value (?).

Return type: CHARACTER

Applies to: Client-principal object handle

Syntax

GET-PROPERTY( property-name )

property-name

A character string that specifies the name of an application-defined property associated with the Client-principal object. You must enclose this character string in quotes.

You can also use the LIST-PROPERTY-NAMES( ) method to retrieve a list of all application-defined properties associated with the Client-principal object.

Example

The following code fragment illustrates how to use the GET-PROPERTY( ) method:

DEF VAR hCP as HANDLE. DEF VAR vVal as CHAR. . . . CREATE CLIENT-PRINCIPAL hCp. . . . vVal = hCP:GET-PROPERTY(“eye-color”). DISPLAY “Eye color: “ vVal.

See also

LIST-PROPERTY-NAMES( ) method, SET-PROPERTY( ) method